home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 414_02 / portable / newpad.c < prev    next >
Encoding:
C/C++ Source or Header  |  1993-06-17  |  2.7 KB  |  102 lines
  1. #define    CURSES_LIBRARY    1
  2. #include <curses.h>
  3. #undef    newpad
  4.  
  5. #ifdef PDCDEBUG
  6. char *rcsid_newpad = "$Header: C:\CURSES\portable\RCS\newpad.c 2.1 1993/06/18 20:20:29 MH Rel MH $";
  7. #endif
  8.  
  9.  
  10.  
  11.  
  12. /*man-start*********************************************************************
  13.  
  14.   newpad()    - Create new pad
  15.  
  16.   X/Open Description:
  17.      Creates a new pad data structure.  A pad is a special case of a
  18.      window, which is not restricted by the screen size, and is not
  19.      necessarily associated with a particular part of the screen.  A
  20.      pad can be used when a large window is needed, and only a part
  21.      of the window will be on the screen at one tme.  Automatic
  22.      refreshes of pads (e.g., from scrolling or echoing of input) do
  23.      not occur.  It is not legal to call refresh() with a pad as an
  24.      argument; the routines prefresh() or pnoutrefresh() should be
  25.      called instead.  Note that these routines require additional
  26.      parameters to specify the part of the pad to be displayed and
  27.      the location on the screen to be used for display.
  28.  
  29.   PDCurses Description:
  30.      PDCurses (as a library) provides the developer with the ability to
  31.      hook in their own malloc debugging  package.  See the details in
  32.      INITSCR.C for details on how to accomplish this.
  33.  
  34.   X/Open Return Value:
  35.      The newpad() function returns a pointer to the new WINDOW structure
  36.      created on success and returns a null pointer on error.
  37.  
  38.   X/Open Errors:
  39.      No errors are defined for this function.
  40.  
  41.   Portability:
  42.      PDCurses    WINDOW* newpad( int nlines, int ncols );
  43.      X/Open Dec '88    WINDOW* newpad( int nlines, int ncols );
  44.      SYS V Curses    WINDOW* newpad( int nlines, int ncols );
  45.  
  46. **man-end**********************************************************************/
  47.  
  48. WINDOW* newpad( int nlines, int ncols )
  49. {
  50. extern    void*    (*mallc)( size_t );
  51. extern    void*    (*callc)( size_t, size_t );
  52. extern    void    (*fre)( void* );
  53.  
  54.     WINDOW* win;
  55.     chtype* ptr;
  56.     int    i;
  57.     int    j;
  58.  
  59. #ifdef PDCDEBUG
  60.     if (trace_on) PDC_debug("newpad() - called: lines=%d cols=%d\n",nlines,ncols);
  61. #endif
  62.  
  63.     if ((win = PDC_makenew( nlines, ncols, -1, -1 )) == (WINDOW *)NULL)
  64.         return( (WINDOW *)NULL );
  65.  
  66.     for (i = 0; i < nlines; i++)
  67.     {
  68.         /*
  69.          * make and clear the lines
  70.          */
  71.         if ((win->_y[i] = (*callc)(ncols, sizeof(chtype))) == NULL)
  72.         {
  73.             for (j = 0; j < i; j++)
  74.             {
  75.                 /*
  76.                  * if error, free all the data
  77.                  */
  78.                 (*fre)(win->_y[j]);
  79.             }
  80.             (*fre)(win->_firstch);
  81.             (*fre)(win->_lastch);
  82.             (*fre)(win->_y);
  83.             (*fre)(win);
  84.             return( (WINDOW *)NULL );
  85.         }
  86.         else
  87.         {
  88.             for (ptr = win->_y[i];
  89.                  ptr < win->_y[i] + ncols;)
  90.             {
  91.                 /*
  92.                 * Retain the original screen attributes...
  93.                 */
  94.  
  95.                 *ptr++ = _cursvar.blank;    
  96.             }
  97.         }
  98.     }
  99.     win->_flags = _PAD;
  100.     return( win );
  101. }
  102.